package com.zenithmind.version.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import com.zenithmind.version.pojo.domain.FileVersion;
import com.zenithmind.version.pojo.dto.FileVersionCreateDTO;
import com.zenithmind.version.pojo.query.FileVersionQueryDTO;
import com.zenithmind.version.pojo.vo.FileVersionVO;

import java.util.List;

/**
 * 文件版本服务接口
 * 
 * @author ZenithMind Team
 * @since 2025-01-09
 */
public interface FileVersionService extends IService<FileVersion> {

    /**
     * 创建文件版本
     * 
     * @param createDTO 创建信息
     * @return 文件版本信息
     */
    FileVersionVO createFileVersion(FileVersionCreateDTO createDTO);

    /**
     * 分页查询文件版本
     * 
     * @param queryDTO 查询条件
     * @return 分页结果
     */
    IPage<FileVersionVO> getFileVersionPage(FileVersionQueryDTO queryDTO);

    /**
     * 获取文件版本详情
     * 
     * @param id 版本ID
     * @return 版本详情
     */
    FileVersionVO getFileVersionDetail(String id);

    /**
     * 获取文件版本历史
     * 
     * @param repositoryId 仓库ID
     * @param filePath 文件路径
     * @param branchName 分支名称
     * @param limit 限制数量
     * @return 版本历史
     */
    List<FileVersionVO> getFileVersionHistory(String repositoryId, String filePath, 
                                             String branchName, Integer limit);

    /**
     * 获取文件当前版本
     * 
     * @param repositoryId 仓库ID
     * @param filePath 文件路径
     * @param branchName 分支名称
     * @return 当前版本
     */
    FileVersionVO getCurrentFileVersion(String repositoryId, String filePath, String branchName);

    /**
     * 获取提交中的文件列表
     * 
     * @param commitId 提交ID
     * @return 文件列表
     */
    List<FileVersionVO> getCommitFiles(String commitId);

    /**
     * 获取分支中的文件列表
     * 
     * @param repositoryId 仓库ID
     * @param branchName 分支名称
     * @param directory 目录路径
     * @return 文件列表
     */
    List<FileVersionVO> getBranchFiles(String repositoryId, String branchName, String directory);

    /**
     * 比较文件版本差异
     * 
     * @param repositoryId 仓库ID
     * @param filePath 文件路径
     * @param fromVersion 源版本
     * @param toVersion 目标版本
     * @return 差异信息
     */
    Object compareFileVersions(String repositoryId, String filePath, String fromVersion, String toVersion);

    /**
     * 获取文件内容
     * 
     * @param versionId 版本ID
     * @return 文件内容
     */
    String getFileContent(String versionId);

    /**
     * 搜索文件
     * 
     * @param repositoryId 仓库ID
     * @param keyword 关键词
     * @param branchName 分支名称
     * @param fileType 文件类型
     * @param limit 限制数量
     * @return 文件列表
     */
    List<FileVersionVO> searchFiles(String repositoryId, String keyword, String branchName, 
                                   String fileType, Integer limit);

    /**
     * 获取文件统计信息
     * 
     * @param repositoryId 仓库ID
     * @param filePath 文件路径
     * @return 统计信息
     */
    Object getFileStatistics(String repositoryId, String filePath);

    /**
     * 恢复文件版本
     * 
     * @param repositoryId 仓库ID
     * @param filePath 文件路径
     * @param branchName 分支名称
     * @param targetVersion 目标版本
     * @param userId 用户ID
     * @return 新版本信息
     */
    FileVersionVO restoreFileVersion(String repositoryId, String filePath, String branchName, 
                                    String targetVersion, String userId);

    /**
     * 复制文件到分支
     * 
     * @param repositoryId 仓库ID
     * @param filePath 文件路径
     * @param sourceBranch 源分支
     * @param targetBranch 目标分支
     * @param userId 用户ID
     * @return 新版本信息
     */
    FileVersionVO copyFileToBranch(String repositoryId, String filePath, String sourceBranch, 
                                  String targetBranch, String userId);

    /**
     * 批量删除文件版本
     * 
     * @param versionIds 版本ID列表
     * @return 是否成功
     */
    Boolean batchDeleteFileVersions(List<String> versionIds);

    /**
     * 获取文件变更统计
     * 
     * @param repositoryId 仓库ID
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 变更统计
     */
    Object getFileChangeStatistics(String repositoryId, String startTime, String endTime);

    /**
     * 获取热门文件
     * 
     * @param repositoryId 仓库ID
     * @param limit 限制数量
     * @return 热门文件
     */
    List<Object> getHotFiles(String repositoryId, Integer limit);

    /**
     * 获取文件目录树
     * 
     * @param repositoryId 仓库ID
     * @param branchName 分支名称
     * @param path 路径
     * @return 目录树
     */
    Object getFileTree(String repositoryId, String branchName, String path);

    /**
     * 下载文件版本
     * 
     * @param versionId 版本ID
     * @param userId 用户ID
     * @return 文件数据
     */
    byte[] downloadFileVersion(String versionId, String userId);

    /**
     * 获取文件预览
     * 
     * @param versionId 版本ID
     * @param userId 用户ID
     * @return 预览数据
     */
    Object previewFile(String versionId, String userId);
}
